*************************************************************************
*									*
*                 send2c64 v1.0	[w]26.5.98 by gpz/hitmen                *
*									*
*************************************************************************

just a little tool so one can finally use some of these fancy cross-asms
in a decent way....

* What for? *

well, its just a simple command line tool to transfer binaries to the
c64 using the PC64-cable (also used by the CROSS64 assembler and HVplay)

* How does it work? *

1) start the reciever on the c64....

- the reciever was assembled to $cf00 and when transfer starts it moves
  itself down to $0100 so that mem from $0200 to $ffff could be used.
  However, to use mem below $0800 the reciever needs some little modification,
  such as removing the i/o reset at the end. Well, as long as you are 
  just doing 'normal' code, dont care about that :=)

	...  start the reciever at $cf00

2) start the sender on the peecee

3) wait some seconds ... ;)

	... if you've configured everything right the program should be
            running now ;=)
   
* syntax: *

send2c64.com file.ext [-sXXXX] [-pXXX]

file.ext 	standard c64 binary with load address
XXXX		file run adress, defaults to $fce2 if not present
XXX		lpt-port base adress (lpt1: 278, lpt2: 378), defaults
		to lpt2 if not present

- this info is also beeing displayed if you supply the program with
  some nonsence parameters ;=)

- actually the command-line parsing code is a real simple one for now,
  to make sure everything works ok always supply all 3 parameters. I'll
  MAYBE change this sometime, but i dont feel like wasting time on
  'cosmetic' code on some PEEECEEE ;=) (if you get a sync-error for no
  reason thats prolly because something with the command line went
  wrong)

btw, as far as i figured there are no problems regarding the lpt-port
mode-settings (SPP/ECP/EPP)

* The PC64-Cable *

(actually you dont need all these connections for this tool, but built
 it all while you are at it, youll most likely want to try some other
 tool using that cable anyway :=)

	C64 Userport        PC Parallel-Port   

	    A ------------------- 25
	    B -------------------  9
	    C ------------------- 15
	    D ------------------- 13
	    E ------------------- 12
	    F ------------------- 10
	    H -------------------  2
	    J -------------------  3
	    K -------------------  4
	    L -------------------  5
 	    M ------------------- 11

* known bugs *

- command line parsing code kinda crippled

mmmmh, have to say for now it really worked fine for me, both on SPP and
ECP/EPP ports and even running under win95... well, theres no error-checking
for now, but i don't think it'll be worth it anyway (since you're using a
direct physical connection between both computers and no noisy phone line
or sth it is very unlikely that there will be any error....i transfered
several crunched programs this way for testing and they all worked - VERY 
unlikely there were wrong bytes in it!)


if you notice any bug in the program or this doc file, please let me know!


					have phun!

					 groepaz/hitmen on 26/5/98

					groepaz@geocities.com
					http://groepaz.home.ml.org

